Departamentos [Desarrolladores]
Consulta y crea departamentos en tu cuenta Adereso desde la API.
Departamentos
Los departamentos permiten organizar a los agentes en equipos temáticos (Ventas, Soporte, etc.) y enrutar tickets automáticamente. Desde la API puedes listarlos y crear nuevos.
¿Para qué sirve?
Los departamentos organizan a tus agentes en equipos (Ventas, Soporte, Logística, etc.) y permiten enrutar tickets automáticamente al equipo correcto. Esta API te permite consultarlos y crear nuevos.
Beneficios concretos
- Crear departamentos automáticamente cuando tu empresa abre una nueva área o sucursal
- Obtener la lista de departamentos para usarla en formularios o lógica de enrutamiento en tu sistema
¿Quién lo usa? Administradores de la plataforma y equipos de tecnología que gestionan la estructura organizacional.
Listar departamentos
/v2/departments/ - GET
Obtiene la lista completa de departamentos configurados en tu cuenta.
Ejemplo de request
curl -H "Authorization: Key TU_TOKEN" \
"https://api-cluster.adere.so/v2/departments/"Ejemplo de respuesta exitosa:
{
"status": 200,
"departments": [
{"id": 1, "name": "Soporte"},
{"id": 2, "name": "Ventas"},
{"id": 3, "name": "Logística"}
]
}Crear departamento
/v2/departments/ - POST
Crea un nuevo departamento en tu cuenta. El nombre debe ser único.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
name | string | Sí | Nombre del departamento (debe ser único) |
Ejemplo de request
curl -X POST \
-H "Authorization: Key TU_TOKEN" \
-H "Content-Type: application/json" \
"https://api-cluster.adere.so/v2/departments/" \
-d '{"name": "Cobranzas"}'Ejemplo de respuesta exitosa:
{
"status": 201,
"department": {"id": 4, "name": "Cobranzas"}
}Códigos de error
Código | Descripción |
400 | Datos inválidos |
401 | No autenticado |
409 | Ya existe un departamento con ese nombre |